package com.gzy.literature.service;

import com.github.pagehelper.PageInfo;
import com.gzy.literature.entity.UserRecommendations;
import org.springframework.dao.DataAccessException;
import org.springframework.data.domain.Page;
import org.springframework.data.domain.PageRequest;

public interface UserRecommendationsService {
    /**
     * 通过ID查询单条数据
     *
     * @param userId 主键
     * @return 实例对象
     */
    UserRecommendations queryById(Integer userId);
    /**
     * 分页查询
     *
     * @param userRecommendations 筛选条件（可以为null或包含部分字段用于筛选）
     * @param pageNum            页码（从1开始）
     * @param pageSize           每页显示的记录数
     * @return 分页查询结果
     */
    PageInfo<UserRecommendations> queryCll(UserRecommendations userRecommendations, int pageNum, int pageSize);
    /**
     * 新增数据
     *
     * @param userRecommendations 实例对象
     * @return 实例对象（通常包含数据库生成的ID或其他字段）
     */
    UserRecommendations insert(UserRecommendations userRecommendations);
    /**
     * 修改数据
     *
     * @param userRecommendations 实例对象（包含要更新的字段和主键）
     * @return 更新后的实例对象，如果更新失败则返回null或抛出异常
     * @throws IllegalArgumentException 如果userRecommendations对象为null或主键字段为空
     * @throws DataAccessException 如果数据库操作失败
     */
    UserRecommendations update(UserRecommendations userRecommendations) throws IllegalArgumentException, DataAccessException;

    /**
     * 通过主键删除数据
     *
     * @param userId 主键
     * @return 是否成功
     */
    boolean deleteById(Integer userId);
}
